Глобальный контекст.ВыгрузитьЖурналРегистрации (Global context.UnloadEventLog)
Глобальный контекст (Global context)
ВыгрузитьЖурналРегистрации (UnloadEventLog)
ВыгрузитьЖурналРегистрации(<Приемник>, <Отбор>, <Колонки>, <ИмяВходногоФайла>, <МаксимальноеКоличество>) <Приемник> (обязательный)
Тип: Строка; ТаблицаЗначений.
Строка, содержащая имя выходного XML файла, либо таблица значений, в которую будут выгружены выбранные в соответствии с отбором записи журнала регистрации.
В случае выгрузки в таблицу значений, она содержит колонки, в соответствии с параметром <Колонки>:- Уровень (Level) - тип УровеньЖурналаРегистрации;
- Дата (Date) - тип Дата;
- Пользователь (User) - идентификатор пользователя, тип УникальныйИдентификатор;
- Компьютер (Computer) - имя компьютера, тип Строка;
- ИмяПриложения (ApplicationName) - имя приложения, тип Строка;
- Событие (Event ) - имя события, тип Строка;
- Комментарий (Comment) - комментарий, тип Строка;
- Метаданные (Metadata) - имя объекта метаданных, тип Строка; для событий "Доступ. Доступ" и "Доступ. Отказ в доступе" в этой колонке может содержаться массив имен объектов метаданных, тип Массив;
- Данные (Data) - данные, произвольного типа, в зависимости от события;
- ПредставлениеДанных (DataPresentation) - представление данных, тип Строка;
- ИмяПользователя (UserName) - имя пользователя, тип Строка;
- ПредставлениеПриложения (ApplicationPresentation) - представление имени приложения, тип Строка;
- ПредставлениеСобытия (EventPresentation) - представление события, тип Строка;
- ПредставлениеМетаданных (MetadataPresentation) - представление объекта метаданных; тип Строка; для событий "Доступ. Доступ" и "Доступ. Отказ в доступе" в этой колонке может содержаться массив представлений объектов метаданных, тип Массив;
- СтатусТранзакции (TransactionStatus) - статус транзакции, тип СтатусТранзакцииЗаписиЖурналаРегистрации;
- Транзакция (TransactionID) - представление транзакции, тип Строка;
- Сеанс (Session) - номер сеанса, тип Число;
- Соединение (Connection) - номер соединения, тип Число;
- РабочийСервер (ServerName) - имя рабочего сервера, тип Строка;
- ОсновнойIPПорт (Port) - номер основного IP-порта, тип Число;
- ВспомогательныйIPПорт (SyncPort) - номер вспомогательного IP-порта, тип Строка;
- РазделениеДанныхСеанса (SessionDataSeparation) - Структура с элементами, имена которых соответствуют именам общих реквизитов, разделяющих данные, а значения - значениям этих общих реквизитов;
- ПредставлениеРазделенияДанныхСеанса (SessionDataSeparationPresentation) - Массив строк вида: <представление общего реквизита>: <представление значения общего реквизита>.
Тип: Структура.
Структура отбора журнала регистрации:- ДатаНачала (StartDate) - Дата; значение по умолчанию Неопределено;
- ДатаОкончания (EndDate) - Дата; значение по умолчанию Неопределено;
- Уровень (Level) - перечисление или массив перечислений; значение по умолчанию Неопределено;
- ИмяПриложения (ApplicationName) - Строка или массив строк; значение по умолчанию Неопределено;
- Пользователь (User) - ПользовательИнформационнойБазы или массив таких объектов, или Строка. Объект ПользовательИнформационнойБазы и массив таких объектов можно получить из объекта МенеджерПользователейИнформационнойБазы. Также можно задавать пользователя по имени (строкой). Причем пользователей, которые были удалены из информационной базы, можно задавать только таким способом. Пустая строка означает "пользователя по умолчанию", который используется, когда в информационной базе нет ни одного пользователя (от имени такого пользователя работают также фоновые задания). Если в отборе задается массив пользователей, то можно перемешивать в нем значения обоих типов - строка и ПользовательИнформационнойБазы. Значение по умолчанию Неопределено;
- Компьютер (Computer) - Строка или массив строк; значение по умолчанию Неопределено;
- Событие (Event) - Строка или массив строк; значение по умолчанию Неопределено. Допустимые системные имена событий:
- _$Access$_.Access - Доступ. Доступ; Предназначено для регистрации фактов успешного доступа пользователей информационной базы к тем или иным данным. Поле журнала регистрации Данные (Структура) в этом случае имеет следующий состав:
- Данные (Data) - скомпонованный результат выборки, поля регистрации данных, к которым обращались. Таблица значений, в которой содержатся данные из результата исполнения запроса. Все вложенные таблицы развернуты. Одинаковые значения пишутся один раз.
- _$Access$_.AccessDenied - Доступ. Отказ в доступе; Предназначено для регистрации фактов отказа в доступе к тем или иным данным пользователям информационной базы. Поле журнала регистрации Данные (Структура) имеет следующий состав:
- Для ошибки доступа к объекту (не ограничение доступа к данным):
- Право (Right) - имя нарушенного права;
- ОбъектДоступа (AccessObject) - Строка;
- Для ошибки ограничения доступа к данным:
- Действие (Action) - Действие, которое выполнялось с данными, для объектных таблиц: Чтение (Read), Добавление (Insert), Изменение (Update), Удаление (Delete); для не объектных таблиц, все что не Чтение, то Изменение;
- Данные (Data) - скомпонованный результат выборки, поля регистрации данных, к которым обращались.Таблица значений, в которой содержатся данные из результата исполнения запроса. Все вложенные таблицы развернуты. Одинаковые значения пишутся один раз.
- _$Data$_.Delete - Данные. Удаление;
- _$Data$_.DeletePredefinedData - Данные. Удаление предопределенных данных;
- _$Data$_.DeleteVersions - Данные. Удаление версий;
- _$Data$_.New - Данные. Добавление;
- _$Data$_.NewPredefinedData - Данные. Добавление предопределенных данных;
- _$Data$_.NewVersion - Данные. Добавление версии;
- _$Data$_.Post - Данные. Проведение;
- _$Data$_.PredefinedDataInitialization - Данные. Инициализация предопределенных данных;
- _$Data$_.PredefinedDataInitializationDataNotFound - Данные. Инициализация предопределенных данных. Данные не найдены;
- _$Data$_.SetPredefinedDataInitialization - Данные. Установка инициализации предопределенных данных;
- _$Data$_.SetStandardODataInterfaceContent - Данные. Изменение состава стандартного интерфейса OData;
- _$Data$_.TotalsMaxPeriodUpdate - Данные. Изменение максимального периода рассчитанных итогов;
- _$Data$_.TotalsMinPeriodUpdate - Данные. Изменение минимального периода рассчитанных итогов;
- _$Data$_.Unpost - Данные. Отмена проведения;
- _$Data$_.Update - Данные. Изменение;
- _$Data$_.UpdatePredefinedData - Данные. Изменение предопределенных данных;
- _$Data$_.VersionCommentUpdate - Данные. Изменение комментария версии;
- _$InfoBase$_.ConfigExtensionUpdate - Информационная база. Изменение расширения конфигурации; Поле Данные заполняется структурой со следующим составом свойств:
- Имя (Name) - Строка. Имя расширения.
- Версия (Version) - Строка. Версия расширения.
- _$InfoBase$_.ConfigUpdate - Информационная база. Изменение конфигурации;
- _$InfoBase$_.DBConfigBackgroundUpdateCancel - Информационная база. Отмена фонового обновления;
- _$InfoBase$_.DBConfigBackgroundUpdateFinish - Информационная база. Завершение фонового обновления;
- _$InfoBase$_.DBConfigBackgroundUpdateResume - Информационная база. Продолжение (после приостановки) процесса фонового обновления;
- _$InfoBase$_.DBConfigBackgroundUpdateStart - Информационная база. Запуск фонового обновления;
- _$InfoBase$_.DBConfigBackgroundUpdateSuspend - Информационная база. Приостановка (пауза) процесса фонового обновления;
- _$InfoBase$_.DBConfigExtensionUpdate - Информационная база. Изменение расширения конфигурации; Поле Данные заполняется структурой со следующим составом свойств:
- Имя (Name) - Строка. Имя расширения.
- Версия (Version) - Строка. Версия расширения.
- _$InfoBase$_.DBConfigExtensionUpdateError - Информационная база. Ошибка изменения расширения конфигурации; Поле Данные заполняется аналогично событию _$InfoBase$_.DBConfigExtensionUpdate (при возможности вывода этих данных);
- _$InfoBase$_.DBConfigUpdate - Информационная база. Изменение конфигурации базы данных;
- _$InfoBase$_.DBConfigUpdateError - Информационная база. Ошибка изменения конфигурации базы данных;
- _$InfoBase$_.DumpError - Информационная база. Ошибка выгрузки в файл; событие доступно при выгрузке и просмотре только для администратора;
- _$InfoBase$_.DumpFinish - Информационная база. Окончание выгрузки в файл; событие доступно при выгрузке и просмотре только для администратора;
- _$InfoBase$_.DumpStart - Информационная база. Начало выгрузки в файл; событие доступно при выгрузке и просмотре только для администратора;
- _$InfoBase$_.EraseData - Информационная база. Удаление данных информационной баз;
- _$InfoBase$_.EventLogReduce - Информационная база. Сокращение журнала регистрации; записываются при сокращении журнала регистрации из конфигуратора. Событие доступно при выгрузке и просмотре только для администратора. Поле Данные заполняется структурой со следующим составом свойств:
- _$InfoBase$_.EventLogReduceError - Информационная база. Ошибка сокращения журнала регистрации; записываются при ошибках сокращения журнала регистрации из конфигуратора. Событие доступно при выгрузке и просмотре только для администратора. Поле Данные заполняется аналогично событию _$InfoBase$_.EventLogReduce (при возможности вывода этих данных);
- _$InfoBase$_.EventLogSettingsUpdate - Информационная база. Изменение настроек журнала регистрации; Событие доступно при выгрузке и просмотре только для администратора. Поле Данные (Структура) заполняется структурой со следующим составом свойств:
- При изменении уровня событий и/или периода разделения журнала регистрации(записываются только измененные параметры):
- ПериодРазделения (SplitPeriod): Строка;
- При изменении формата журнала регистрации:
- ФорматЖурналаРегистрации (EventLogStructure): Строка;
- ПериодРазделения (SplitPeriod): Строка;
- При настройке использования событий журнала регистрации (с помощью метода УстановитьИспользованиеСобытияЖурналаРегистрации):
- ИмяСобытия (EventName) - Строка;
- СобытиеРегистрируется (EventIsLogged) - Булево;
- _$InfoBase$_.EventLogSettingsUpdateError - Информационная база. Ошибка изменения настроек журнала регистрации; Событие доступно при выгрузке и просмотре только для администратора. Поле Данные заполняется аналогично событию _$InfoBase$_.EventLogSettingsUpdate (при возможности вывода этих данных);
- _$InfoBase$_.InfoBaseAdmParamsUpdate - Информационная база. Изменение параметров информационной базы; Событие доступно при выгрузке и просмотре только для администратора. Поле Данные (Структура) заполняется структурой со следующим составом свойств (записываются только измененные параметры):
- ВремяОжиданияБлокировкиДанных (LockWaitTime): Число;
- МинимальнаяДлинаПаролейПользователей (UserPasswordMinLength): Число;
- ПроверкаСложностиПаролейПользователей (UserPasswordStrengthCheck): Булево;
- ВремяЗасыпанияПассивногоСеанса (PassiveSessionHibernateTime): Число;
- ВремяЗавершенияСпящегоСеанса (HibernateSessionTerminateTime): Число;
- _$InfoBase$_.InfoBaseAdmParamsUpdateError - Информационная база. Ошибка изменения параметров информационной базы; Событие доступно при выгрузке и просмотре только для администратора. Поле Данные заполняется аналогично событию _$InfoBase$_.InfoBaseAdmParamsUpdate (при возможности вывода этих данных);
- _$InfoBase$_.MasterNodeUpdate - Информационная база. Изменение главного узла;
- _$InfoBase$_.PredefinedDataUpdate - Информационная база. Обновление предопределенных данных;
- _$InfoBase$_.RegionalSettingsUpdate - Информационная база. Изменение региональных установок;
- _$InfoBase$_.RestoreError - Информационная база. Ошибка загрузки из файла; событие доступно при выгрузке и просмотре только для администратора;
- _$InfoBase$_.RestoreFinish - Информационная база. Окончание загрузки из файла; событие доступно при выгрузке и просмотре только для администратора;
- _$InfoBase$_.RestoreStart - Информационная база. Начало загрузки из файла; событие доступно при выгрузке и просмотре только для администратора;
- _$InfoBase$_.SetPredefinedDataUpdate - Информационная база. Установить обновление предопределенных данных;
- _$InfoBase$_.TARImportant - Тестирование и исправление. Ошибка;
- _$InfoBase$_.TARInfo - Тестирование и исправление. Сообщение;
- _$InfoBase$_.TARMess - Тестирование и исправление. Предупреждение;
- _$Job$_.Cancel - Фоновое задание. Отмена;
- _$Job$_.Fail - Фоновое задание. Ошибка выполнения;
- _$Job$_.Start - Фоновое задание. Запуск;
- _$Job$_.Succeed - Фоновое задание. Успешное завершение;
- _$Job$_.Terminate - Фоновое задание. Принудительное завершение;
- _$OpenIDProvider$_.NegativeAssertion - Провайдер OpenID. Отклонено; записывается базой, выступающей в роли провайдера OpenID, при отправке отрицательного ответа на запрос аутентификации. Поле Комментарий события не заполняется. Поле Данные заполняется структурой со следующим составом свойств:
- URLДоверяющейСтороны (RelyingPartyURL) - URL доверяющей стороны OpenID, запросившей аутентификацию.
- _$OpenIDProvider$_.PositiveAssertion - Провайдер OpenID. Подтверждено; записывается базой, выступающей в роли провайдера OpenID, при отправке положительного ответа на запрос аутентификации. Поле Комментарий события не заполняется. Поле Данные заполняется структурой со следующим составом свойств:
- Имя (Name) - Строка. Выбирается из Имя;
- URLДоверяющейСтороны (RelyingPartyURL) - URL доверяющей стороны OpenID, запросившей аутентификацию;
- _$PerformError$_ - Ошибка выполнения;
- _$Session$_.Authentication - Сеанс. Аутентификация; выполняется только при удачной аутентификации. Для события Аутентификация записываются поля Пользователь и ИмяПользователя. Поле Комментарий события не заполняется. В случае аутентификации 1С:Предприятия или аутентификации операционной системы поле Данные заполняется структурой со следующим составом свойств:
- ПользовательОС (OSUser) - Строка. Выбирается из ПользовательОС;
- Имя (Name) - Строка. Выбирается из Имя;
- ТекущийПользовательОС (CurrentOSUser) - Строка. Источник данных - средства операционной системы.
- В случае аутентификации при помощи OpenID поле Данные заполняется структурой со следующим составом свойств:
- ТекущийПользовательОС (CurrentOSUser) - Строка. Источник данных - средства операционной системы;
- URLПровайдераOpenID (OpenIDProviderURL) - URL использованного провайдера OpenID;
- ИдентификаторПользователяПровайдераOpenID (OpenIDProviderUserID) - идентификатор пользователя на провайдере.
- _$Session$_.AuthenticationError - Сеанс. Ошибка аутентификации; выполняется только при ошибке аутентификации. Поле Комментарий события не заполняется. В случае аутентификации 1С:Предприятия или аутентификации операционной системы поле Данные заполняется структурой со следующим составом свойств:
- ПользовательОС (OSUser) - Строка. Выбирается из ПользовательОС;
- Имя (Name) - Строка. Выбирается из Имя;
- ТекущийПользовательОС (CurrentOSUser) - Строка. Источник данных - средства операционной системы.
- В случае аутентификации при помощи OpenID поле данные заполняется структурой со следующим составом свойств:
- ТекущийПользовательОС (CurrentOSUser) - Строка. Источник данных - средства операционной системы;
- URLПровайдераOpenID (OpenIDProviderURL) - URL использованного провайдера OpenID
- _$Session$_.ConfigExtensionApplyError - Сеанс. Ошибка применения расширения конфигурации; записывается, если в процессе применений расширения произошла ошибка. Совпадает с текстом выводимого сообщения при невозможности подключить расширение. Поле Данные заполняется структурой со следующим составом свойств:
- Имя (Name) - Строка. Имя расширения
- _$Session$_.Finish - Сеанс. Завершение;
- _$Session$_.Start - Сеанс. Начало;
- _$Transaction$_.Begin - Транзакция. Начало;
- _$Transaction$_.Commit - Транзакция. Фиксация;
- _$Transaction$_.Rollback - Транзакция. Отмена;
- _$User$_.Delete - Пользователи. Удаление; записываются как при редактировании списка пользователей в Конфигураторе, так и при удалении пользователей методами встроенного языка. Поле Данные доступно при выгрузке и просмотре только для администратора. Поле Данные заполняется структурой со следующим составом свойств:
- _$User$_.DeleteError - Пользователи. Ошибка удаления; записываются как при редактировании списка пользователей в Конфигураторе, так и при удалении пользователей методами встроенного языка. Поле Данные доступно при выгрузке и просмотре только для администратора. Поле Данные заполняется аналогично событию _$User$_.Delete (при возможности вывода этих данных);
- _$User$_.New - Пользователи. Добавление; записываются как при создании пользователей в Конфигураторе, так и методами встроенного языка. Поле Данные доступно при выгрузке и просмотре только для администратора. Поле Данные заполняется структурой со следующим составом свойств:
- _$User$_.NewError - Пользователи. Ошибка добавления; записываются как при создании пользователей в Конфигураторе, так и методами встроенного языка. Поле Данные доступно при выгрузке и просмотре только для администратора. Поле Данные заполняется аналогично событию _$User$_.New (при возможности вывода этих данных);
- _$User$_.Update - Пользователи. Изменение; записываются как при редактировании списка пользователей в Конфигураторе, так и при изменении пользователей методами встроенного языка. Поле Данные доступно при выгрузке и просмотре только для администратора. Поле Данные заполняется структурой со следующим составом свойств:
- _$User$_.UpdateError - Пользователи. Ошибка изменения; записываются как при редактировании списка пользователей в Конфигураторе, так и при изменении пользователей методами встроенного языка. Поле Данные доступно при выгрузке и просмотре только для администратора. Поле Данные заполняется аналогично событию _$User$_.Update (при возможности вывода этих данных);
- Метаданные (Metadata) - объект описания метаданного или их массив; значение по умолчанию Неопределено;
- Данные (Data) - значение, тип значения – ссылка на объект (СправочикСсылка и т.д.); значение по умолчанию Неопределено;
- ПредставлениеДанных (DataPresentation) - Строка;
- Комментарий (Comment) - Строка;
- СтатусТранзакции (TransactionStatus) - перечисление или массив перечислений; значение по умолчанию Неопределено;
- Транзакция (TransactionID) - идентификатор транзакции; Строка;
- Сеанс (Session) - номер сеанса пользователя. Число или массив чисел; значение по умолчанию Неопределено;
- РабочийСервер (ServerName) - Строка или массив строк; значение по умолчанию Неопределено;
- ОсновнойIPПорт (Port) - номер основного IP-порта рабочего процесса; Число или массив чисел; значение по умолчанию Неопределено;
- ВспомогательныйIPПорт (SyncPort) - номер вспомогательного IP-порта рабочего процесса. Число или массив чисел; значение по умолчанию Неопределено.
- РазделениеДанныхСеанса (SessionDataSeparation) - Структура, имена элементов которой соответствуют именам общих реквизитов. В процессе отбора элементы структуры РазделениеДанныхСеанса объединяются по И: запись журнала попадает в выборку, если в ней есть соответствия для всех общих реквизитов, заданных в отборе. Значение по умолчанию Неопределено.
- Значение элемента структуры, в свою очередь, может быть:
- структурой, задающей единичное значение. Элементы структуры:
- Значение (Value) - значение общего реквизита. Значение по умолчанию - Неопределено;
- Использование (Use) - Булево. Значение по умолчанию - Истина. Задает использование общего реквизита, разделяющего данные. Если Ложь - элемент Значение игнорируется и может быть опущен. Таким образом можно отбирать записи журнала, в которых данный общий реквизит не установлен.
- массивом, который задает набор допустимых значений общего реквизита, разделяющего данные. Массив содержит структуры, каждая из которых задает единичное значение общего реквизита (как описано выше). Элементы массива учитываются по ИЛИ: запись журнала попадает в выборку, если значение общего реквизита в ней равно одному из заданных в массиве.
<Колонки> (необязательный)
Тип: Строка.
Для того чтобы выгрузить определенные колонки журнала регистрации необходимо перечислить их имена, при этом необходимо имя каждой колонки отделять запятой.
Доступны следующие колонки:- Уровень (Level);
- Дата (Date);
- Пользователь (User);
- Компьютер (Computer);
- ИмяПриложения (ApplicationName);
- Событие (Event);
- Комментарий (Comment);
- Метаданные (Metadata);
- Данные (Data);
- ПредставлениеДанных (DataPresentation);
- ИмяПользователя (UserName);
- ПредставлениеПриложения (ApplicationPresentation);
- ПредставлениеСобытия (EventPresentation);
- ПредставлениеМетаданных (MetadataPresentation);
- СтатусТранзакции (TransactionStatus);
- Транзакция (TransactionID);
- Сеанс (Session);
- Соединение (Connection);
- РабочийСервер (ServerName);
- ОсновнойIPПорт (Port);
- ВспомогательныйIPПорт (SyncPort);
- РазделениеДанныхСеанса (SessionDataSeparation);
- ПредставлениеРазделенияДанныхСеанса (SessionDataSeparationPresentation).
Если не задан, то будут выгружены значения всех колонок. <ИмяВходногоФайла> (необязательный)
Тип: Строка.
Строка, содержащая имя входного файла. <МаксимальноеКоличество> (необязательный)
Тип: Число.
Ограничивает число считываемых методом событий журнала.
Если параметр не указан или равен 0 - без ограничения.
Если указано конечное число, метод считывает последние в хронологическом порядке события с учетом установленного отбора в количестве, не превышающем значения параметра.Выгружает журнал регистрации. Существует возможность установить отбор, задаваемый структурой специального формата, указывающий, какие записи журнала регистрации выгружать, а также указать колонки, которые необходимо выгружать. Если указано имя входного файла, то происходит выгрузка из указанного файла.
Требует наличия у пользователя права ЖурналРегистрации (EventLog). Отсутствие права приводит к возникновению исключения.
Сервер, толстый клиент, внешнее соединение.При записи событий имена элементов структур и колонок таблиц значений записываются на языке, соответствующем варианту встроенного языка конфигурации.
Открывает файл журнала в режиме, разрешающем совместную запись.Глобальный контекст, метод ПолучитьЗначенияОтбораЖурналаРегистрации